home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / conf400.zip / RENUM.DOC < prev    next >
Text File  |  1988-07-21  |  3KB  |  75 lines
  1.      RENUM - Revision: 4.10 by Bob Hartman, FidoNet Node 1:132/101
  2.      Copyright 1985-88 Spark Software, Inc.   All rights reserved.
  3.  
  4. *************************************************************************
  5. * NOTE: This version of RENUM uses very low level DOS calls.  As a      *
  6. * result, it may not run on some systems.  In particular, LAN,          *
  7. * multi-tasking, or caching software has been found to be troublesome   *
  8. * depending upon the particular configuration.  Before using RENUM on   *
  9. * an unattended basis, it is HIGHLY recommended that a complete system  *
  10. * backup be made and the results of the RENUM commands checked very     *
  11. * closely.  Since such low level code is being used, if RENUM screws    *
  12. * up, it will probably take the entire disk with it.  Bob Hartman       *
  13. * and Spark Software take no responsibility if this program does        *
  14. * anything nasty.  You use it at your own risk.  It has been tested     *
  15. * successfully on many systems, but that in no way means it will run on *
  16. * your system.                                                          *
  17. *************************************************************************
  18.  
  19. This version of RENUM is optimized for use on Echomail areas, and
  20. areas that are more or less contiguous before it is run.  It sometimes
  21. is not as fast as old versions of RENUM when just doing message base
  22. renumbering, but it is much faster when killing messages as well as
  23. renumbering them with one command.  The command line is as follows
  24. (note, it is different from previous versions of RENUM):
  25.  
  26.     RENUM [-D days] [-N save1 save2] [-K] [-S] [-R] directory
  27.  
  28. -D Kill by days:
  29.         days is the number of days of messages to save.
  30.  
  31. -N Kill by number:
  32.         save1 is the number of messages to skip before killing.
  33.         save2 is the number of messages that should exist after save1
  34.                 messages are saved.
  35.  
  36. -K Kill received messages
  37.  
  38. -S Kill sent messages
  39.  
  40. -R Renumber messages
  41.  
  42. directory:
  43.         Name of directory to renumber.  If specified as a number, the
  44.         SYSTEMxx.BBS file is used to get the directory name.  This
  45.         will also trigger the renumbering of the user list (if it
  46.         exists in the current directory).
  47.  
  48. This version of RENUM is not very fast when dealing with message
  49. bases with large holes in them, but echomail is not normally that
  50. way.  It is optimized for having as many of the options as are
  51. necessary on one command line.  Only one directory can be renumbered
  52. with each invocation (again, a difference from earlier versions of
  53. RENUM).
  54.  
  55. Some examples:
  56.  
  57.         RENUM -D 10 -N 1 100 -R C:\Msgs\Tech
  58.         This will first kill messages older than 10 days, then save
  59.         1.MSG and kill messages until there are 100 left after 1.MSG.
  60.         Finally, the message base will be renumbered.
  61.  
  62.         RENUM -K -D 10 -N 0 50 -R 2
  63.         In area 2, kill received messages, kill messages more than 10
  64.         days old, only save 50 after that, and then renumber the
  65.         messages (and because an area number was specified, update
  66.         the user.bbs file).
  67.  
  68. This version of RENUM is able to handle messages numbered up to 2048
  69. in any directory.  Beyond that, the program will give unpredictable
  70. results.
  71.  
  72. For version 4.10 I would like to thank Greg Dawson for an excellent
  73. suggestion which significantly increased the speed of message
  74. deletion.
  75.